This action efficiently reads lines of text from a specific location in a file. The file has to be located on the server file system.

Triggers

<Path> (non-repetitive text trigger [required]): The path that identifies the input file.

<Byte Offset> (non-repetitive numeric trigger [not required]): The starting position (in bytes) at which extraction should start (starting from 0). The default is 0

<Max Lines> (non-repetitive numeric trigger [not required]): The maximum number of lines to read

<Encoding> (non-repetitive numeric trigger [not required]): The character encoding used to read the file. The default encoding is the system's default encoding.

Exits

<Text> (non-repetitive text exit [not required]): The extracted lined as a single block of text. If no lines were found, no value is returned. The text includes line separators (between the lines and at the end of the last lines).

<Total Size> (non-repetitive numeric exit [not required]): The total size of the file, in bytes

<End Offset> (non-repetitive numeric exit [not required]): The offset in bytes after the end of the last extracted line
Specifically, if we read through the end of the file then <End Offset> and <Total Size> will be the same.
<End Offset> is useful as the <Byte Offset> when we want to read the next lines in the file

<More Lines> (non-repetitive empty exit [not required]): Indicates that there are additional lines in the file.

<Number of Lines Returned> (non-repetitive numeric exit [not required]): The number of lines returned in the output

Note: This plugin reads complete lines. If the file does not end in a newline character, the part of the file following the last newline character will not be read (and so <End Offset> will be smaller than <Total Size> while there are no additional lines)